home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / winsock / wlprs40c.zip / WLPRSPL.ASC < prev    next >
Text File  |  1995-02-01  |  32KB  |  747 lines
  1. Windows LPR Spooler Version 4.0c - UserÆs Guide
  2.             Windows LPR Spooler Version 4.0c - UserÆs Guide
  3. 16
  4.                                                           1
  5.                              
  6.                              
  7.                              
  8.                              
  9.                              
  10.                              
  11.                              
  12.                              
  13.                              
  14.                              
  15.                              
  16.                              
  17.              Windows LPR Spooler Version 4.0c
  18.                              
  19.                              
  20.                  A Network Printer Spooler
  21.                  for Microsoft Windows 3.1
  22.                              
  23.                              
  24.                        UserÆs Guide
  25.                              
  26.                              
  27.                          (Rev. 1)
  28.                              
  29.                              
  30.                      February 1, 1995
  31.                              
  32.                              
  33.                              
  34.                              
  35.                              
  36.                              
  37.                              
  38.                              
  39. This  document was created with Microsoft Word for  Windows
  40. 6.0
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47. DISCLAIMER:
  48.  
  49. THE  SOFTWARE  IS PROVIDED AS-IS. THE AUTHOR DISCLAIMS  ALL
  50. WARRANTIES,  EITHER EXPRESS OR IMPLIED, INCLUDING  BUT  NOT
  51. LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS
  52. FOR  A  PARTICULAR  PURPOSE. NO LIABILITY  IS  ASSUMED  FOR
  53. DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE
  54. USE OF THIS SOFTWARE.
  55.  
  56. (C) Copyright 1992-94 by Thomas Heil.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. All  trademarks appearing in this document are the property
  68. of their respective owners.
  69.  
  70.  
  71. Table of Contents
  72.  
  73. Table of Contents                                         3
  74. Introduction                                              5
  75. New Features                                              5
  76. Requirements                                              5
  77. Package Contents                                          6
  78. Installation                                              6
  79. If you upgrade ...                                        7
  80. How Does the Spooler Work?                                8
  81. First Start                                               8
  82. Adding/Changing Network Printer Definitions               9
  83. Adjusting WLPRSPL Operating Parameters                   10
  84. WLPRSPL Running ...                                      11
  85. WLPRSPL Menu Options                                     12
  86. Usage Notes                                              14
  87. Troubleshooting                                          14
  88. Change Log                                               15
  89. Licensing and Registration                               16
  90.     Registration Fee                                       16
  91. One Final Word ...                                       16
  92. Registration Form                                        17
  93.  
  94.  
  95. _Introduction
  96.  
  97. Windows  LPR  Spooler, in the following  text  abbreviated  as
  98. WLPRSPL,  is a program which allows transparent printing  from
  99. Microsoft   Windows  3.1  applications  to  network  printers.
  100. WLPRSPL allows you to define a large number of remote printers
  101. which may be addressed through different Protocol DLLs.
  102.  
  103. Included  with  the program is WLPR2.DLL which implements  the
  104. Line  Printer  Daemon (LPD, RFC1179) protocol that  is  widely
  105. used  on UNIX hosts. DLL's that support other network printing
  106. protocols will be developped over time. (For details on  which
  107. Protocol  DLLs  currently exist, please  contact  the  author.
  108. Note: Protocol DLLs other than those included in the shareware
  109. version will be available to registered users only.)
  110.  
  111.  
  112. New Features
  113.  
  114. Version 4.0 offers the following new features:
  115.  
  116. ╖    Support of the new WLPR2.DLL API which allows WLPRSPL  to
  117.    use  different  Protocol DLLs for different remote  printer
  118.    queues  (like  the included WLPR2.DLL that  implements  the
  119.    LPR/LPD protocol).
  120. ╖    The spooler can run in a so-called "unattended mode".  In
  121.    this mode the spooler automatically retries failed print file
  122.    transfers after a user-definable amount of time. The user is
  123.    not interactively notified of such failures. Spool failures
  124.    are  displayed  in the relevant queue line of  the  spooler
  125.    window.
  126.  
  127.  
  128. Requirements
  129.  
  130. The following components are required to run WLPRSPL:
  131.  
  132. ╖   Microsoft Windows 3.1
  133. ╖   WLPR2.DLL or compatible Protocol DLL(s).
  134.  
  135. If  the  spooler is used together with the included WLPR2.DLL,
  136. the following additional components are required:
  137.  
  138. ╖    TCP/IP  networking  software for the  PC  that  offers  a
  139.    WinSock 1.1 compliant WINSOCK.DLL.
  140. ╖   WSOCKAID.DLL Version 1.0 or later. Users that run a TCP/IP
  141.    stack other than FTP Software's should note the comment in the
  142.    "Installation" section below.
  143.  
  144.  
  145. Package Contents
  146.  
  147. This  package  contains  the  spooler  (WLPRSPL.EXE)  and  the
  148. supporting  libraries  WLPR2.DLL  Version  2.0a,  WSOCKAID.DLL
  149. Version  2.0,  and CTL3D.DLL Version 2.05,  as  well  as  this
  150. documentation in form of a PostScript file and a  plain  ASCII
  151. version.
  152. The following files are included in the standard distribution:
  153.  
  154. WLPRSPL.EXE       The main program.
  155. WLPRSPL.PS/.ASC   Program documentation.
  156. WLPR2.DLL         The  Protocol DLL which supports the LPR/LPD
  157.                   protocol.
  158. WLPR2.PS/.ASC     The documentation for WLPR2.DLL.
  159. WSOCKAID.DLL      A  supporting  DLL  that contains  functions
  160.                   missing in WINSOCK.DLL.
  161. WSOCKAID.PS/.ASC  The documentation for WSOCKAID.DLL.
  162. WSAIDCNF.CPL      A  Control  Panel extension that allows  the
  163.                   setting of the username for WSOCKAID.DLL.
  164. CTL3DV2.DLL       A  DLL that allows dialog boxes to have a 3D
  165.                   look.
  166. CTRLD10B.ZIP      An  archive  that contains a  small  utility
  167.                   with   which  one  can  enable/disable   the
  168.                   generation  of  a  leading Ctrld-D  for  any
  169.                   installed PostScript printer driver.
  170.  
  171.  
  172. Installation
  173.  
  174. Choose  a  directory  where you want to  install  WLPRSPL  and
  175. create it. Move the archive WLPRSnnn.ZIP to this directory and
  176. unzip  it  with  PKUNZIP  2.04g or a compatible  uncompression
  177. program. Move all W*.DLL files to the Windows directory or  to
  178. another  directory  that  is  in your  PATH,  or  include  the
  179. directory  where  you installed WLPRSPL into your  PATH.  Move
  180. CTL3DV2.DLL  to  your WINDOWS/SYSTEM directory after  checking
  181. that there is not already a newer version. If there already is
  182. a  newer  version in the WINDOWS/SYSTEM directory, delete  the
  183. one in the spoolerÆs installation directory. Make sure that no
  184. other  copy of this DLL remains on your PC; otherwise the  DLL
  185. might  complain that it is not properly installed. Then either
  186. create  a  new Program Manager group or open an existing  one,
  187. and  install  WLPRSPL.EXE there (please refer to your  Windows
  188. documentation on how to do this). After that you can start the
  189. program  for the first time. For your convenience  you  should
  190. install  the spooler also in your AUTOSTART group so  that  it
  191. gets launched automatically when you start Windows.
  192.  
  193. A  note  about WSOCKAID.DLL: This is a network software vendor
  194. specific DLL containing a few functions that WINSOCK.DLL  does
  195. not  offer.  Currently you will not get  this  DLL  from  your
  196. vendor.  The version in this pack was written by us explicitly
  197. for FTP Software's PC/TCP stack. The function that WLPRSPL (or
  198. better WLPR2.DLL) uses is retrieving the user's login name. If
  199. you  have  FTP Software's PC/TCP 2.1 or higher, this DLL  will
  200. take  the  needed  information from  the  PCTCP.INI  file  (or
  201. whatever  your PCTCP environment variable is set to).  If  you
  202. use  a  different  stack, you may copy  WSAIDCNF.CPL  to  your
  203. WINDOWS/SYSTEM directory. This small applet then allows you to
  204. set the username in the Control Panel.
  205. Note  that  the  username is the only  thing  which  WLPR2.DLL
  206. retrieves  from  WSOCKAID.DLL.  All  other  information   that
  207. WSOCKAID.DLL can give (as described in WSOCKAID.ASC or .PS) is
  208. ignored.  The local PC hostname for example is retrieved  from
  209. the  networking software directly (through WINSOCK.DLL), which
  210. means  that you have to have a PC hostname configured in  your
  211. networking  software. Protocol DLLs other than  WLPR2.DLL  may
  212. behave   differently.   Refer   to   the   corresponding   DLL
  213. documentation.
  214.  
  215. If  you  use a TCP/IP stack that offers a real Windows network
  216. driver,  then  WSOCKAID.DLL  tries  to  inquire  the  username
  217. through  this driver instead of returning the INI file  entry.
  218. You  can verify if your TCP/IP software uses such a driver  by
  219. looking  at  SYSTEM.INI section [boot]. If a  non-empty  entry
  220. "network.drv=<drivername>"  exists,   then   your   networking
  221. software has such a driver.
  222.  
  223. For further details concerning the included DLLs please take a
  224. look at the corresponding .ASC or .PS files.
  225.  
  226.  
  227. If you upgrade ...
  228.  
  229. If  you  upgrade  from  Version  3.x  to  4.0c,  WLPRSPL  will
  230. recognize  this the first time you start the new version.  You
  231. will  be prompted if the settings of the old version shall  be
  232. retained. If you accept this, you will further be prompted  if
  233. the  old  Queue Definition File shall be converted to the  new
  234. format (which now is in standard Windows .INI format).
  235.  
  236. The old Queue Definition File must be writable when you choose
  237. to  update it automatically. So if you have a shared QDF on  a
  238. network  drive you should start the new version on a  PC  with
  239. write  access to this file first. It then gets converted,  and
  240. on all other PCs you can skip the conversion when WLPRSPL 4.0c
  241. is started for the first time there.
  242.  
  243. You  can later load 3.x  style QDFs with the Setup/Queues/Load
  244. queue  definitions...  menu option. The program  automatically
  245. determines that the file is not a 4.0 QDF and asks if the file
  246. shall be read as 3.x QDF. After the file is read you can  save
  247. it as 4.0 file.
  248.  
  249. Note  that the spooler settings are no longer kept in  WIN.INI
  250. but in WLPRSPL.INI in the Windows directory.
  251.  
  252.  
  253. How Does the Spooler Work?
  254.  
  255. Every  printer used within Windows is connected to a so-called
  256. "port."  Examples are LPT1, LPT2, COM1, COM2  etc.  But  those
  257. ports can also be normal disk files. When you add the line
  258.    
  259.    C:\SPOOL\DRUCKER.DAT=
  260.    
  261. to  the  [ports]  section of WIN.INI you may later  connect  a
  262. printer  driver to this "port." Every print job sent  to  this
  263. port  is  written to the specified file. This is what  WLPRSPL
  264. relies on. WLPRSPL uses a dedicated directory on the PCs  hard
  265. disk  for spooling (i.e. C:\SPOOL). This directory has  to  be
  266. specified  the  first  time you start the  program.  For  each
  267. network  printer  you want to print to you have  to  define  a
  268. unique  file name (i.e. HP.PCL for a HP LaserJet in PCL mode).
  269. This  file name together with the chosen spool directory forms
  270. the   port   (in  this  case  C:\SPOOL\HP.PCL)  to  which   an
  271. appropriate  Windows  printer driver  can  be  connected.  The
  272. filename without path represents the local queue.
  273.  
  274. A  remote  printer  is  defined by the  local  queue  name  as
  275. described above, the remote printer name, the host name of the
  276. computer  that  acts as printer server, and the  name  of  the
  277. Protocol  DLL to be used for connecting to the remote printer.
  278. The  definitions of all remote printers are kept  in  a  Queue
  279. Definition  File (which will be abbreviated as  QDF  from  now
  280. on). When starting the spooler for the first time, you have to
  281. specifiy  the location of this file. It may either be  located
  282. on  a  local  drive, but it could also be on a shared  network
  283. drive   where  it  is  maintained  by  some  network   printer
  284. administrator.
  285.  
  286. You  define  remote  printers by filling  in  the  information
  287. described   above   into  the  queue  setup  dialog.   WLPRSPL
  288. automatically creates the needed port in WIN.INI so  that  you
  289. later  can  install  an appropriate printer  driver  for  this
  290. remote printer.
  291.  
  292. When  you  print  to  such a network  driver  from  a  windows
  293. application,  the printer data is written to the corresponding
  294. spool  file. WLPRSPL then puts the file into its own  queueing
  295. system and sends the data to the remote printer.
  296.  
  297.  
  298. First Start
  299.  
  300. When  you start WLPRSPL for the first time you have to specify
  301. the  spool  directory  you want to use.  In  the  dialog  that
  302. appears you can also create new subdirectories. Once you  have
  303. selected  the  spool directory, you have to define  the  place
  304. where the QDF shall be located. It is possible to use a shared
  305. QDF  that  resides on a network drive and which is  maintained
  306. centrally. The file that you specify does not have to exist at
  307. this  time. It will be created as soon as you define the first
  308. queue in WLPRSPL.
  309.  
  310. After  this  first  time configuration you  may  define  local
  311. queues  for all remote printers you want to utilize.  This  is
  312. described  in  the  next  section.  Then  you  should  install
  313. appropriate Windows printer drivers for your network  printers
  314. and connect them to the corresponding port.
  315.  
  316.  
  317. Adding/Changing Network Printer Definitions
  318.  
  319. In  order  to  define network printers in  WLPRSPL  start  the
  320. program if not yet running, restore the program window if  the
  321. program   is   iconized,   and   select   the   menu    option
  322. Setup/Queues/Define new queue... or press Alt-Insert. A dialog
  323. pops up where you can enter a new queue definition. The fields
  324. in this dialog have the following meaning:
  325.  
  326. Local Spool File:  Name of the spool file (without path) that
  327.                    shall be used for the local queue.
  328. Remote Print Name: Name of the queue on the remote print
  329.                    server.
  330. Remote Host Name:  Internet host name or address of the remote
  331.                    print server.
  332. DLL to be used:    Specifies the Protocol DLL to be used for
  333.                    this remote printer. It may be either the
  334.                    name only (which lets WLPRSPL search for it
  335.                    in the standard search order) or a fully
  336.                    qualified path name. WLPR2.DLL is the
  337.                    default for new queues.
  338.  
  339. After  filling in all fields you can review/change the options
  340. that  are  in  effect  for this queue by  pressing  the  Queue
  341. properties...  button. The options in the  dialog  popping  up
  342. depend on the specified Protocol DLL. For the meaning of those
  343. options please refer to the DLL's documentation.
  344. When  you press OK in the "Edit queue data" dialog, a new port
  345. is   created  if  needed.  Now  you  can  go  to  the  Control
  346. Panel/Printer Setup, install a printer driver that matches the
  347. remote printer, and connect it to the corresponding port. Take
  348. care  that  all printer characteristics you define  match  the
  349. remote  printer. Normally a datastream from a Windows  printer
  350. driver  overrides settings of the remote printer defaults.  If
  351. you  select settings that the remote printer does not  support
  352. it may hang.
  353.  
  354. If  you  want  to  change the definition of a remote  printer,
  355. select it in the main window listbox and click the menu option
  356. Setup/Queues/Edit  queue data... or press Alt-Enter.  You  get
  357. the  queue  setup dialog box with the currently  valid  values
  358. filled in, ready to be altered.
  359. Changes to queues are not automatically saved. This has to  be
  360. done either through Setup/Queues/Save queue definitions, or by
  361. accepting  the automatic saving when WLPRSPL (or  Windows)  is
  362. terminated.
  363.  
  364. After  installing  the printer driver you  may  print  to  the
  365. remote printer from any Windows application.
  366.  
  367.  
  368. Adjusting WLPRSPL Operating Parameters
  369.  
  370. Through  the  menu (Setup/Preferences...) you  can  get  to  a
  371. dialog  box  where  you  can change  the  following  operating
  372. parameters of WLPRSPL.
  373.  
  374. Timer ticks in This entry defines the time steps used by
  375. sec.           WLPRSPL to periodically check for possible
  376.                spool files. It can be 0 which means that
  377.                this feature is disabled. With this feature
  378.                enabled it is possible to create spool
  379.                files in DOS sessions and have them
  380.                automatically entered into the WLPRSPL
  381.                queueing system (see Usage Notes).
  382.                Default is 0.
  383. Warn if        When this check box is activated (default),
  384. suspended      you get a warning every time you print to a
  385.                remote network printer if the spooler is
  386.                currently suspended.
  387.                Default is on.
  388. Unattended     When this check box is activated, the
  389. mode           spooler is in "Unattended Mode". This means
  390.                that the user is not notified of spooling
  391.                errors. Instead the faulty queue is
  392.                temporarily disabled, and is re-enabled
  393.                after the number of seconds specified.
  394.                Default is on.
  395. Automatically  If unattended mode is on, this entry
  396. re-enable      specifies after how long a failed print
  397. queue after    file transfer is retried.
  398. ... sec.       Default is 300 seconds.
  399.  
  400. Normally you can leave the default values as they are. If  you
  401. notice a performance degradation on slow PCs due to the  spool
  402. file polling set the Timer Ticks to a higher value, or set  it
  403. to 0 if this feature is not needed.
  404.  
  405.  
  406. WLPRSPL Running ...
  407.  
  408. When  WLPRSPL is active you normally don't notice anything  of
  409. its  existance because the spooling is done in the background.
  410. The  WLPRSPL  main window always shows you what  is  currently
  411. going on. You see the following information being displayed:
  412.  
  413. ╖   the time the spooler was started
  414. ╖    the  mode  in  which  Windows  is  running  (Standard  or
  415.    Enhanced)
  416. ╖   the current state of the spooler (suspended or active)
  417. ╖   the current run mode of the spooler ("unattended" or
  418. "interactive")
  419. ╖   the currently used spool directory
  420. ╖   the currently used Queue Definition File
  421. ╖   a listbox displaying the states of all local queues (more
  422. detailed description below)
  423. ╖   the Windows printer driver used for the currently selected
  424.    (and therefore highlighted) queue
  425.  
  426. The  individual  columns  in the listbox  have  the  following
  427. meaning:
  428.  
  429. Symbol          If blank the local queue is currently not
  430.                 connected to a printer driver, if ">" it
  431.                 is connected, if "*" it is connected and
  432.                 is currently selected as default printer.
  433. Red "E"         If present, it indicates that there was
  434.                 some spool error. You can check this error
  435.                 with the Queues/Show last error... menu
  436.                 option and remove the flag with the
  437.                 Queues/Clear error flag menu option.
  438. Loc. Queue      Name of the local queue (and of the spool
  439.                 file).
  440. Rem. Queue      Name of the queue on remote print server.
  441. Host            Name of remote print server.
  442. Spool tries     Number of print jobs sent over this queue
  443. unsucc./succ.   since WLPRSPL was started or since the
  444.                 queue statistics were reset, and number of
  445.                 times the current spool file in a queue
  446.                 failed to be sent.
  447. Files queued    Number of unsent print jobs.
  448.  
  449. Permanently  disabled queues (that means "disabled  by  user")
  450. are   shown  with  red  text.  A  temporarily  disabled  queue
  451. (disabled because of spool error in unattended mode) is  shown
  452. with  yellow text. A queue that is active sending a print  job
  453. is  shown  in  green, and the statistics are replaced  with  a
  454. progress message.
  455.  
  456.  
  457. WLPRSPL Menu Options
  458.  
  459. Following  is a list with all available menu options.  On  the
  460. right hand side the keyboard short cut is shown.
  461.  
  462. Files
  463.    Delete next spool file                             (Delete)
  464.        Delete next spool file in selected local queue.
  465.    Delete all spool files in queue               (Ctrl-Delete)
  466.        Delete all spool files in selected local queue.
  467.    Delete all spool files                  (Shift-Ctrl-Delete)
  468.        Delete all spool files in all local queues.
  469.    Cancel spooling                                    (Ctrl-C)
  470.        A currently running transfer is cancelled.
  471.    Suspend/Resume spooler                             (Ctrl-S)
  472.        The  spooler is suspended, or its operation is resumed,
  473.        depending on the current state of the spooler. When the
  474.        spooler is suspended, no print jobs are transferred  to
  475.        remote printers.
  476.    Control Panel                                      (Ctrl-P)
  477.        Call the control panel.
  478.    Exit                                     (Ctrl-X or Alt-F4)
  479.        Exit WLPRSPL.
  480. Queues
  481.    Show remote printer status                         (Ctrl-Q)
  482.        Shows  the state of the remote printer that corresponds
  483.        to  the  selected  local  queue  by  executing  an  LPQ
  484.        request.  The  dialog box showing  the  remote  printer
  485.        status   then   allows  refreshing  the   display   and
  486.        cancelling one or more remote print jobs.
  487.    Show jobs in local queue                           (Ctrl-L)
  488.        Opens  a dialog box that shows all jobs which are still
  489.        in  the  currently selected local queue. In this dialog
  490.        box   you   have   the  possiblity  of  removing   jobs
  491.        individually.
  492.    Enable/Disable queue(Ctrl-A or doubleclick on queue in listbox)
  493.        The selected local queue is enabled/disabled.
  494.    Scan queues immediately
  495.         (Ctrl-I or click right mouse button on WLPRSPL symbol)
  496.        The  spool  directory is scanned for  new  spool  files
  497.        immediately.
  498.    Retry to spool now                                 (Ctrl-N)
  499.        If  the  queue is in retry timeout state (yellow  text)
  500.        because an error occured when trying to send the active
  501.        spool file, the spooler retries immediately to send the
  502.        file instead of waiting for the time to expire.
  503.    Select as default printer                          (Ctrl-D)
  504.        The  printer connected to the currently selected  queue
  505.        is made the Windows default printer.
  506.    Show last error...                                 (Ctrl-E)
  507.        A message describing the last spool error is displayed.
  508.    Clear error flag                                   (Ctrl-F)
  509.        A message describing the last spool error is displayed.
  510.    Reset selected queue                               (Ctrl-R)
  511.        The statistics of the selected local queue are reset.
  512.    Reset all queues                             (Shift-Ctrl-R)
  513.        The statistics of all local queues are reset.
  514. Setup
  515.    Preferences...
  516.        Activates  the  dialog described in "Adjusting  WLPRSPL
  517.        Operating Parameters"
  518.    Spool-Directory...
  519.        Activates  the  dialog  for  selection  of  the   spool
  520.        directory described in "First Start".
  521.    Queues >
  522.        Define new queue                           (Alt-Insert)
  523.            Activates  the  dialog  for defining  a  new  queue
  524.            described   in  "Adding/Changing  Network   Printer
  525.            Definitions".
  526.        Edit queue data                             (Alt-Enter)
  527.            Activates   the  dialog  for  editing  queue   data
  528.            described   in  "Adding/Changing  Network   Printer
  529.            Definitions". The dialog is filled with the data of
  530.            the currently selected local queue.
  531.        Delete queue                               (Alt-Delete)
  532.            Deletes the currently selected local queue.
  533.        Reload queue definitions
  534.            Reloads  the  queue definitions from the  currently
  535.            active QDF.
  536.        Load queue definitions...
  537.            Activates  the dialog for selecting a QDF described
  538.            in "First Start".
  539.        Save queue definitions
  540.            Saves  changes  made to a queue definition  in  the
  541.            currently active QDF.
  542.        Save queue definitions as...
  543.            Saves  the current queue definitions to a QDF which
  544.            must first be selected. If wanted, this new QDF can
  545.            be  made the currently active QDF, which will  then
  546.            be used the next time WLPRSPL starts.
  547.    Register Program...
  548.        Activates the program registration dialog. If you  have
  549.        a  pre-registered  version of the  program,  this  menu
  550.        option is grayed.
  551.  
  552.  
  553.  
  554. Usage Notes
  555.  
  556. ╖    When  the  spool  directory is changed  after  the  first
  557.    installation, new ports are automatically generated for all
  558.    local queues in the [ports] section of WIN.INI. The user then
  559.    has  to  manually connect all printer drivers to those  new
  560.    ports. This is currently not done automatically.
  561. ╖    If you have a DOS application that can print to a file in
  562.    addition  to printing to a real LPTx or COMx, you  can  use
  563.    WLPRSPL to spool those files. Just let the application print
  564.    to  the  file that defines the port for the desired network
  565.    printer   (i.e.  C:\SPOOL\HP.PCL).  Then  there   are   two
  566.    possibilities to initiate the transfer: Either you have set
  567.    the  Timer Ticks to a non-zero value. In this case you only
  568.    have to wait for the specified number of seconds, and WLPRSPL
  569.    puts the file into its queueing system. If you have disabled
  570.    this feature you can also switch back to WLPRSPL with Alt-Tab
  571.    and select Queues/Scan queues immediately from the menu  or
  572.    click on the WLPRSPL icon with the right mouse button.
  573. ╖    The  state  of all queues (enabled/disabled,  number  and
  574.    names of spool files) is saved in the spool directory as file
  575.    filename.SPL, where filename corresponds to the name of the
  576.    QDF.  When, for example, the name of the QDF is WLPRSPL.QS,
  577.    then  the name of the queue state file is WLPRSPL.SPL. This
  578.    file should not be deleted because it is needed to determine
  579.    to which local queue any unsent spool files belong.
  580. ╖    When  you  print  to a remote printer that  automatically
  581.    detects  PostScript files and you get the  PostScript  text
  582.    printed, this usually happens due to the fact that the Windows
  583.    PostScript driver prepends the PS datastream with a  Ctrl-D
  584.    (0x04). This character normally causes a locally attached PS
  585.    printer to reset, but it also makes it impossible for network
  586.    queues to recognize the print data as PS file. Included  in
  587.    this  package  is  a ZIP archive called CTRLD10B.ZIP  which
  588.    contains  a  small  Windows  utility  that  allows  you  to
  589.    selectively enable or disable the Ctrl-D generation for all
  590.    installed PS printers.
  591.  
  592.  
  593. Troubleshooting
  594.  
  595. If  you  have problems with the spooler that can't be resolved
  596. through  this document please take a look at the documentation
  597. of  the  supporting DLLs. There are given some troubleshooting
  598. tips  which  are specific to those DLLs. If this  fails,  too,
  599. please  feel free to contact us. But do not forget to  provide
  600. us with info about the program version, your operating system,
  601. and  your  networking software, as well  as  info  about  what
  602. printer  and  printer server you use (model, operating  system
  603. etc.)
  604.  
  605.  
  606. Change Log
  607.  
  608. Version 4.0a:
  609. ╖   Package includes WLPR2.DLL Version 2.0a.
  610. ╖    The  logic  when  saving the state of a  queue  (enabled,
  611.    disabled,  retry timeout) was changed. Now, if a  queue  is
  612.    permanently disabled, it will stay in this state  when  you
  613.    close down the spooler and later restart it. Previously,  a
  614.    disabled  queue  went into "Retry timeout" state  when  the
  615.    spooler was restarted.
  616. ╖    In  the  "Edit Queue Data" dialog the "Local Spool  File"
  617.    name now is limited to 12 characters.
  618. ╖   Long queue and host names extended into the data right of
  619. it in the main window list box. They are now truncated in the
  620. display.
  621. ╖    In  unattended  mode, the error code of  a  failed  spool
  622.    attempt is now kept and can be displayed with the Queues/Show
  623.    last error... menu option. If an error occured, this is also
  624.    indicated with a red "E" at the beginning of the relevant line
  625.    in the spooler's main window listbox.
  626.  
  627. Version 4.0b:
  628. ╖   Package includes WLPR2.DLL Version 2.0b.
  629. ╖    The  file name generation scheme for the spool files  has
  630.    been changed. Previously it was based on the time with a  1
  631.    second resolution which caused two print jobs to be given the
  632.    same name if printed within one second.
  633. ╖   More keyboard accelerators for menu functions.
  634. ╖    The default Windows printer can now be changed within the
  635.    spooler to one of the WLPRSPL queues by right-doubleclicking
  636.    on a spooler queue.
  637.  
  638. Version 4.0c:
  639. ╖    Package  includes WLPR2.DLL Version 2.0c and WSOCKAID.DLL
  640.    Version 2.0b.
  641. ╖   The main window uses a smaller font now.
  642. ╖    Fixed  a bug that caused the spooler to hang when  adding
  643.    queues after it was started without any queue being defined.
  644. ╖    The Spooler now recognizes when it runs under Windows NT.
  645.    In this case the timer ticks in the Preferences dialog cannot
  646.    be changed and remain 0. Otherwise print jobs might be chopped
  647.    into several parts.
  648.  
  649.  
  650. Licensing and Registration
  651.  
  652. This  software is not free. It is shareware. You  are  granted
  653. the right to test this software for a period of 30 days. After
  654. this  you have to register the product (see registration  form
  655. at  the end of this document) and, if this applies to you, pay
  656. the required registration fee.
  657.  
  658. The  unregistered shareware version displays a message box  at
  659. the  program start reminding you that the program has not  yet
  660. been  registered.  When you register the program,  you  get  a
  661. serial  number  and  a corresponding key. Start  the  spooler,
  662. select  the  Setup/Register Program... menu option,  and  type
  663. your user information together with serial number and key into
  664. the dialog box. Then press the OK button.
  665.  
  666. You may redistribute this program to other persons as long  as
  667. you  keep  the  package complete with all the files  that  are
  668. listed  in  the  "Contents" section at the beginning  of  this
  669. document.
  670. Registration Fee
  671.  
  672. Contact  us (see next section) for the registration price.  We
  673. also offer site/company licenses.
  674.  
  675.  
  676. One Final Word ...
  677.  
  678. Tell  us everything you like or dislike about this program  in
  679. order  to let us make it better. Tell us about functions  that
  680. you  would like to see added. Tell us about problems you  have
  681. encountered.
  682.  
  683. You  can reach us under the following E-mail addresses  (first
  684. in the list preferred):
  685.  
  686.     th.heil@kfa-juelich.de
  687.     ich211@zam001.zam.kfa-juelich.de
  688.     ich211@djukfa11.bitnet
  689.     ich211@ich210.ich.kfa-juelich.de
  690.     CompuServe: 100434,2167
  691.  
  692. or by ordinary mail as
  693.  
  694.     Susanne Heil EDV-Vertrieb
  695.     Hindenburgstr. 50
  696.     41352 Korschenbroich
  697.     Germany
  698.  
  699. or by fax under +49 (0)2161 644337
  700.  
  701.  
  702. _Registration Form
  703.  
  704. (Please register WLPRSPL 4.0c when you decide to use it beyond
  705. the trial period of 30 days.)
  706.  
  707.  
  708.                   Name: 
  709.            Institution: 
  710.             Department: 
  711.                 Street: 
  712.           City/Town and 
  713.          ZIP/Post Code: 
  714.                  State: 
  715.                Country: 
  716.           Phone number: 
  717.             FAX number: 
  718.         E-Mail address: 
  719.        Customer Number1 
  720.  
  721. I  would  like  to register _______ Windows LPR  Spooler  4.0c
  722. licenses
  723.  
  724. for          an educational/no-profit institution.Total price:
  725. DM
  726.              a commercial/for-profit institution. Total price:
  727. DM
  728.  
  729. Payment:   Remittance to:Bank: Stadtsparkasse  Korschenbroich,
  730. Germany
  731.                        Bank Routing Code: 310 512 40  Account:
  732. 149401
  733.           included Cheque (in German currency)
  734.  
  735.  
  736.  
  737.           Date/Signature
  738.  
  739. Please mail this form (with a possible fee included) to
  740.  
  741.        Susanne Heil EDV-Vertrieb
  742.        Hindenburgstr. 50
  743.        41352 Korschenbroich
  744.        Germany
  745. _______________________________
  746. 1from a previous registration
  747.